home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 016 / mdosmenu.arc / MDSMENU2.TXT < prev    next >
Encoding:
Text File  |  1984-04-26  |  39.8 KB  |  1,057 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                               DOS Menu Master V2.0
  13.  
  14.                                   User's Manual
  15.  
  16.  
  17.                                Stuart A. Jones MD
  18.  
  19.                                    April, 1984
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                   Copyright (C) Stuart A. Jones MD, 1983, 1984
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.           Copyright (C) Stuart Jones 1984        Page 1
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.                                 Table of Contents
  73.          
  74.  
  75.              Introduction........................................3
  76.  
  77.              Installation Instructions...........................5
  78.  
  79.              Routine Operation...................................7
  80.  
  81.              Theory of Operation................................12
  82.  
  83.              Advanced Applications..............................13
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.           Copyright (C) Stuart Jones 1984        Page 2
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.                                   Introduction
  139.  
  140.              This  manual describes installation,  routine use,  and  the 
  141.         operation  of  the  DOS Menu Master  program.   This  program  is 
  142.         designed  to  free  the  occasional user of  IBM  PC-DOS  (R)  or 
  143.         Microsoft  MS-DOS  (R) from having to learn the operating  system 
  144.         commands necessary to perform such routine operations as  listing 
  145.         the  directory  of  a diskette,  copying files from  diskette  to 
  146.         diskette, formatting fresh diskettes, etc.  Menu Master does this 
  147.         by  first  giving the user a menu of operations to  choose  from.  
  148.         The  user  is then asked additional questions pertaining  to  his 
  149.         choice.   The  program  then alters  a DOS batch file (a  set  of 
  150.         commands to the operating system,  held in a diskette text file).  
  151.         The  user  can  then go back to  the  menu,  and  choose  another 
  152.         operation,  if he so desires.  When the user is finished with the 
  153.         menu  program,  the batch file is then automatically fed to  DOS, 
  154.         which then executes each of the commands.
  155.              This  version of the program is designed for use with PC-DOS 
  156.         version  2.x  (MS-DOS  version 2.x) on computer  systems  with  a 
  157.         'fixed  disk' (or hard disk) or some other form of  high-capacity 
  158.         mass storage (e.g DSQD 5.25" or 8" floppy disk or removable  hard 
  159.         disk).  The advanced directory management features of PC-DOS V2.0 
  160.         and  MS-DOS  V2.1  are  directly available to the user  via  this 
  161.         version  of  Menu  Master.    Version  1.3  of  Menu  Master   is 
  162.         specifically  designed to work with the less advanced versions of 
  163.         PC-DOS and MS-DOS.   If you are not certain which version of  DOS 
  164.         you are using, ask your computer dealer.
  165.              Although  this  program is designed for the novice  computer 
  166.         user, anyone wishing to operate this program MUST understand what 
  167.         a 'file' and a 'volume' are.   A 'volume' is, for the purposes of 
  168.         both DOS and Menu Master,  a single hard disk or diskette and the 
  169.         data contents thereof.   Before data can be written on a disk,  a 
  170.         pattern of magnetic pulses called the 'format' must be written on 
  171.         the disk, and a specific area on the disk which is used to hold a 
  172.         directory of data contents must be cleared ('initialized').  Data 
  173.         can  then  be  written on the disk,  in  the  form  of  'files'--
  174.         organized collections of data, each of which is assigned space on 
  175.         the disk by DOS, and each of which has an entry in the directory, 
  176.         which serves as a form of index to the data.
  177.              Files are identified to DOS by means of a 'File Name'.   The 
  178.         File  Name  is  in two parts--a name,  up to  8  characters,  and 
  179.         beginning with a letter,  and an extension,  up to 3  characters.  
  180.         The  name and extension are separated by a period ('.')  You  are 
  181.         encouraged  to  read the material pertaining to files  and  their 
  182.         naming in your DOS manual.
  183.              Volumes  are  identified  to DOS according to  the  diskette 
  184.         drive in which they currently reside.  At present, volumes may be 
  185.         named (in PC-DOS V2.0 and MS-DOS V2.1),  but the volume names are 
  186.         not operationally significant.   The diskette drives are labelled 
  187.         'A:'  (or 'a:'),  'B:',  'C:',  etc.   These labels refer to  the 
  188.         actual physical position of each diskette drive.  For example, on 
  189.         the IBM Personal Computer,  the A: drive is that on the left.  On 
  190.         the IBM Personal Computer XT,  the A: drive is the diskette drive 
  191.  
  192.  
  193.           Copyright (C) Stuart Jones 1984        Page 3
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.         (on  the  left)  and the C:  drive is the 'fixed  disk'  (on  the 
  203.         right).You  are again encouraged to read about disk drive  naming 
  204.         in your manuals.
  205.              Under  DOS 2.x,  more than one directory may be found  on  a 
  206.         volume.   This  is  necessary to manage the very large number  of 
  207.         files that can be stored on a hard disk.   For each volume, there 
  208.         is a 'root' directory.  Any additional directories for the volume 
  209.         must be listed either in the root directory, in another directory 
  210.         which is, in turn, listed in the root directory, etc.  The system 
  211.         of  directories forms a 'tree',  with the root directory  forming 
  212.         the trunk, other directories listed in the root directory forming 
  213.         the  first branches,  additional directories listed in the  first 
  214.         branch directories forming the second branches, other directories 
  215.         listed  in  the  second  branch  directories  forming  the  third 
  216.         branches,  etc.   It  is  theoretically possible to form  a  very 
  217.         complex directory tree using this system; in practice, it is best 
  218.         to keep the directory scheme as simple as possible.
  219.              Each  directory  may  list  files,   in  addition  to  other 
  220.         directories.   These  files  are analagous to the leaves  on  the 
  221.         'tree'.   The root directory may also contain files.  In order to 
  222.         access data files or programs within a particular directory, that 
  223.         directory  must  be selected as  the  'current'  directory.   The 
  224.         particular  directory is named by specifying the 'path' along the 
  225.         branches,  starting at the root,  that must be taken to reach it.  
  226.         The names of the intervening directories must be specified within 
  227.         the path, separated by 'backslash' characters (\).
  228.              For  example,   suppose  the  root  directory  contains  the 
  229.         directories  DOS  and WP.   The DOS directory  contains  all  DOS 
  230.         utility  program  files,  and  the WP  directory  contains  word-
  231.         processing files, including the directory LETTERS, which contains 
  232.         letter  files.    The  'path'  to  the  letter  files  would  be:  
  233.         '\DOS\LETTERS' (the initial '\' represents the root directory).
  234.              In  order  to  specify a file or a program  to  DOS,  it  is 
  235.         necessary to tell DOS the directory path to the file.  You should 
  236.         note that this may be the path from the CURRENT directory, rather 
  237.         than the root directory;  however,  the safest path to specify is 
  238.         that  from the root directory,  which DOS will always  recognize.  
  239.         You  are  encouraged  to read about DOS 2.x directories  in  your 
  240.         manual.  Please be reassured, however, that if you have installed 
  241.         Menu  Master V2.0 in the root directory,  you need only know  the 
  242.         path from the root directory to any file you wish to  reach,  and 
  243.         you need not worry about changing directories or specifying paths 
  244.         to DOS on your own.
  245.              With  this  information and Menu Master,  it is possible  to 
  246.         perform most routine DOS file and volume maintainance  activities 
  247.         without  learning the exact DOS commands required.   You will  be 
  248.         exposed  to  these  commands,  since they are  displayed  as  DOS 
  249.         executes each one.   The batch files you create can also be saved 
  250.         for later use, if you desire.
  251.              Menu  Master is a copyrighted product of Nuclear Software of 
  252.         Allentown, Pa.  This program is distributed as 'Share-ware'.  You 
  253.         are  encouraged to copy and share this program with your  friends 
  254.         and associates.   If you,  or they, find this program worthwhile, 
  255.         you  are encouraged to send a contribution of $30 to the  address 
  256.         below.   This will enroll you among the registered users of  Menu 
  257.  
  258.  
  259.           Copyright (C) Stuart Jones 1984        Page 4
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.         Master.  As a registered user, you will receive notice of updates 
  269.         and  improvements  in the program,  as well as information  about 
  270.         other products from our company.   Contributions,  questions  and 
  271.         comments should be referred to:
  272.  
  273.                                  Nuclear Software
  274.                                  1045 Treeline Dr.
  275.                                  Allentown, Pa. 18103
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.           Copyright (C) Stuart Jones 1984        Page 5
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.                             Installation Instructions
  337.  
  338.  
  339.              These  instructions  explain  how to copy  the  Master  Menu 
  340.         program  MMENU2.EXE  from the distribution diskette to your  hard  
  341.         disk, and how to run MMENU2 to set up the necessary batch file.
  342.              In  order  for DOS to successfully carry  out  all  commands 
  343.         built into MMENU2,  the following files should be present on your 
  344.         hard  disk,  in a directory named DOS which is listed in the root 
  345.         directory (path = \DOS):
  346.  
  347.              CHKDSK.COM
  348.              DISKCOPY.COM
  349.              DISKCOMP.COM
  350.              BASICA.COM
  351.              FORMAT.COM
  352.  
  353.         FORMAT.COM must be renamed 'FMT.COM',  in order to work with Menu 
  354.         Master.   If  you wish to 'lock out' a command (such  as  FORMAT, 
  355.         which  can  be abused to accidentally destroy the contents of  an 
  356.         entire  hard  disk!),  leave the appropriate file off  your  hard 
  357.         disk.
  358.              Installation of MMENU2 can be completed in five easy steps:
  359.  
  360.              1)  Place the MMENU2 distribution diskette in drive  A:.  It 
  361.         is  assumed  that the current directory is the root directory  on 
  362.         drive C: (the fixed disk).
  363.  
  364.              2)  Type the following:  copy a:mmenu.exe<enter>
  365.         ('<enter>' means press the 'enter' key (just above 'PrtSc' on the 
  366.         IBM XT and most look-alikes))
  367.  
  368.              3)  Type the following:  copy a:format.bat c:\dos<enter>.
  369.  
  370.              4)  When the copy operation is complete, type: mmenu<enter>
  371.         The menu will be displayed, after some disk activity. 
  372.  
  373.              5)   Press the 'F9' key.   In response to the next  question 
  374.         (Execute Prior Commands?),  type  <enter>.   After some more disk 
  375.         activity,  the computer will print the 'A>'prompt .   You are now 
  376.         back at DOS command level.
  377.  
  378.              At this point, you have created a batch file--'menu.bat', as 
  379.         well as a data file, 'menu.dat'.  These files are used to run the 
  380.         Menu Master program automatically.  MMENU2 alters 'menu.bat', and 
  381.         loads this file with the commands you select from the menu.
  382.              Apart  from  MMENU2.EXE,  which requires 35K  characters  of 
  383.         diskette storage space,  the files involved take up little  space 
  384.         on disk.
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.           Copyright (C) Stuart Jones 1984        Page 6
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.                                 Routine Operation
  403.  
  404.  
  405.              The  DOS Menu Master Program is run by typing:  menu<enter>.  
  406.         MMENU2.EXE cannot be effectively used outside of the batch  file, 
  407.         menu.bat.
  408.              In  routine  operation,  the  altered  batch  file  menu.bat 
  409.         will  be  executed  by DOS immediately  after  you  finish  using 
  410.         MMENU2.   When menu.bat is run, the last command executed will be 
  411.         'menu'--which starts up MMENU2 again.
  412.              When MMENU2 begins operation, it erases the previous version 
  413.         of  menu.bat,  and reads the number of the operation chosen  last 
  414.         from  the  menu  from  menu.dat.   MMENU2  next  reads  the  file 
  415.         menu.app,  which holds a subsidiary menu of applications commands 
  416.         set up by you or your computer dealer.   MMENU2 then displays the 
  417.         menu:
  418.  
  419.              File Maintainence:
  420.  
  421.                 1 - List Directories of Disk(s)
  422.                 2 - Copy File(s)
  423.                 3 - Display/Print Text File
  424.  
  425.              Volume Maintainence:
  426.  
  427.                 4 - Format Diskette in Drive A:
  428.                 5 - Copy (Backup) Entire Diskette Contents
  429.  
  430.              Other:
  431.  
  432.                 6 - Run a DOS Program or Batch File
  433.                 7 - Run a BASIC Program
  434.                 8 - Exit to BASIC
  435.                 9 - Exit to DOS
  436.                10 - Run Application From Menu
  437.  
  438.              Default -- Repeat Last Operation
  439.  
  440.              Your choice:
  441.  
  442.  
  443.         In  response  to the prompt,  'Your choice:  ',  you may enter  a 
  444.         number  from 1 to 10,  or press a function key.   Press  'F1'  to 
  445.         select choice 1,  'F2' to select choice 2, etc. etc.  MMENU2 will 
  446.         then  ask  one  or more questions depending on which  option  you 
  447.         chose.  After you have answered the questions, you will be asked, 
  448.         in most cases,  '(C)ontinue or (E)xecute? '. If your reply begins 
  449.         with the letter 'c' (either capital or lower-case),  MMENU2  will 
  450.         return  you  to the menu for another choice.   If you  choose  to 
  451.         'execute',  MMENU2 saves the number of your last chosen operation 
  452.         in menu.dat,  finishes setting up menu.bat,  and exits.   At this 
  453.         point,  if you are running automatically, menu.bat is executed by 
  454.         DOS.
  455.  
  456.  
  457.           Copyright (C) Stuart Jones 1984        Page 7
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.              The questions asked pertaining to each menu choice,  and the 
  467.         default answers to them, are described below.  Please note that a 
  468.         'default'  answer  is  one assumed by MMENU2 if  you  only  press 
  469.         <enter> in reply to a question.
  470.  
  471.         1 - List Directories of Disk(s)
  472.  
  473.              The first question is:  Directory Path:
  474.         The default answer selects the current (root) directory.  To list 
  475.         the  contents  of another directory,  you must specify it by  its 
  476.         full path and name.   For example, for directory UTILITIES, which 
  477.         is listed in directory DOS,  which is in turn listed in the  root 
  478.         (\) directory, you would type:  '\dos\utilities<enter>'.
  479.              The next question is:  (A)ll or (S)elected Files?
  480.         The default answer is All.  Your reply must begin with the letter 
  481.         's'  if  you wish to list selected files.   If you do,  the  next 
  482.         question is:  File Name (name.ext):
  483.              You may,  at this point,  enter a file name using  so-called 
  484.         'wild  card' notation.   For example,  to list all files with the 
  485.         name 'demo',  you would enter:  demo.*<enter>.  To list all files 
  486.         with  the  extension BAS (i.e.  all BASIC  programs),  you  would 
  487.         enter:   *.bas<enter>.  'Wild cards' are explained in the section 
  488.         of your DOS manual dealing with file names.   By all means,  read 
  489.         this section.
  490.              If you have selected 'All' files,  or after you have entered 
  491.         a file name, the next question is:  Disk Drive (A, B, C...):
  492.         Enter the single letter corresponding to the disk drive in  which 
  493.         currently resides the volume whose directory you wish to see.  If 
  494.         you  enter a colon (':') after the letter,  don't  worry;  MMENU2 
  495.         will  recognize your answer anyway.   The default is the drive in 
  496.         which resides the diskette you are currently using to run MMENU2.
  497.              You will then be asked:  (R)egular or (W)ide?
  498.         The  default is 'regular'.   The directory,  in this  form,  will 
  499.         appear  as  a single column of file names,  each with a  size  in 
  500.         characters and a creation date.  If more than 24 files are in the 
  501.         directory,  the listing will pause until you strike a  key.   The 
  502.         wide  form  (selected by entering a reply beginning  with  letter 
  503.         'w')  displays file names only,  in four columns,  and will pause 
  504.         for you to strike a key only at the end of the display listing.
  505.              You will then be asked to Continue or Execute.
  506.  
  507.         2 - Copy File(s)
  508.  
  509.              
  510.              The first question is:  Source Device (A, B, C... or CON):
  511.         You may enter a single letter for the diskette drive holding  the 
  512.         volume  containing the file(s) you wish to copy,  or specify CON, 
  513.         in  which  case  you can create a single  file  typing  from  the 
  514.         keyboard,  a  process described in your DOS manual.   Creating  a 
  515.         text  file from CON:  is NOT RECOMMENDED unless you know  EXACTLY 
  516.         what  you are doing.   This can be a useful 'quick and dirty' way 
  517.         of creating text files without using a text editor.   If the file 
  518.         you  are creating is to be more than 4-5 lines long,  better  use 
  519.         EDLIN.COM, or a word-processing program if you have one.
  520.              The next question is:  Source Directory Path:
  521.  
  522.  
  523.           Copyright (C) Stuart Jones 1984        Page 8
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.         You must specify the directory path to the file(s) to be  copied.  
  533.         The default is the root directory.  This question is not asked if 
  534.         the source device is CON:.
  535.              The next question asked is:  File Name (name.ext):
  536.         Again,  you  may  use 'wild card' notation to specify a group  of 
  537.         files to be copied.  A default reply returns you to the menu.
  538.              The next question is:   Destination Device (A,  B,  C...  or 
  539.         LPT1).  Enter a letter for the disk drive holding the destination 
  540.         volume.   If you enter: lpt1:<enter>, the files will be copied to 
  541.         your  lineprinter,   if  you  have  one.    If  you  specify  the 
  542.         lineprinter  as  the destination,  at this  point,  TURN  IT  ON.  
  543.         Trying  to  copy  to an inactive lineprinter will only  cause  an 
  544.         error message in most versions of MS-DOS (including all  versions 
  545.         of  PC-DOS),  but  MAY  'hang  up'  the  computer  (cause  it  to 
  546.         mysteriously stop functioning, in which case you must turn it off 
  547.         and  then back on again).   If you select the lineprinter for the 
  548.         destination, the next two questions will not be asked.
  549.              The next question is:  Destination Directory Path:
  550.         You must specify the full path to the directory to hold the files 
  551.         being  copied.    The  default  is  the  root  directory  of  the 
  552.         destination device (a good choice for diskettes).
  553.              The final question is:  Destination File Name (name.ext):
  554.         A default answer causes the file(s) to have the same name on  the 
  555.         destination volume as on the source volume.   If you enter a file 
  556.         name,  do  so CAREFULLY,  as this effectively changes the name of 
  557.         the file you are copying to this new name.  Be especially careful 
  558.         if  you use 'wild cards'.   The best answer to this  question  is 
  559.         usually a default.   You can always rename files later, using the 
  560.         DOS 'rename' command (q.v. in your Friendly DOS Manual).
  561.  
  562.         3 - Display/Print Text File
  563.  
  564.              You are first asked:  Disk Drive (A, B, C...):
  565.         Enter a drive letter, as above.
  566.              You are then asked:  Directory Path:
  567.         Enter  the  directory  path  to the file(s) to  be  displayed  or 
  568.         printed.
  569.              You are then asked:  File Name (name.ext):
  570.         You  may  use a 'wild card',  but this  is  not  recommended,  as 
  571.         multiple  files specified with a 'wild card' will be displayed or 
  572.         printed without a break between files.
  573.              The last question is:  (C)onsole or (P)rinter?
  574.         The  default is 'console'--i.e.  displaying file contents on  the 
  575.         screen.   Your  reply must begin with letter 'p' to specify  hard 
  576.         copy.
  577.  
  578.         4 - Format Diskette in Drive A:
  579.  
  580.              If you select this option,  you are planning to write format 
  581.         data on a (hopefully) previously blank diskette in disk drive a:.
  582.         Please,  before  proceeding,  INSERT THE BLANK DISKETTE IN  DRIVE 
  583.         A:!!!   Formatting  the  diskette will ERASE ALL  DATA  currently 
  584.         residing  upon  it!   As such,  formatting is  useful  for  'bulk 
  585.         erasing'  diskettes with potentially sensitive data you no longer 
  586.         need.  You will be asked only one question:  Copy DOS?
  587.  
  588.  
  589.           Copyright (C) Stuart Jones 1984        Page 9
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.         The default reply is 'yes'.   The formatted diskette will then be 
  599.         usable as a DOS system diskette.  If you wish to use the diskette 
  600.         for data only,  your reply must begin with letter 'n'.  You will, 
  601.         of course be asked to Continue or Execute.
  602.              Once again, PLEASE BE CAREFUL when exercising this option.
  603.  
  604.         5 - Copy (Backup) Entire Diskette Contents
  605.  
  606.              You will be asked:  Source Disk Drive (A, B, C...):
  607.         and then:  Destination Disk Drive (A, B, C...):
  608.         A default to either question will cause the copying operation  to 
  609.         misfire.   No harm will result;  but no copying will, either.  If 
  610.         you  mistakenly enter the same answer to both  questions,  MMENU2 
  611.         will point out your error,  and return you to the menu.   If not, 
  612.         and  you are copying between diskettes (i.e.  drive A:  to  drive 
  613.         B:), you will then be asked:  Verify Copy?
  614.              The  default  answer (a good one--strongly  recommended)  is 
  615.         'yes'.   To  suppress verification (checking that the copying was 
  616.         exact),  your reply must begin with letter 'n'.   The DOS program 
  617.         DISKCOPY  is  used  to execute this  option.   When  menu.bat  is 
  618.         executed by DOS,  and DISKCOPY is run,  you will be instructed by 
  619.         DISKCOPY  to insert source and target volumes in the disk  drives 
  620.         you have specified.  Please, BE CAREFUL!!!  If you place the disk 
  621.         you are copying in the wrong drive,  you may WIPE IT CLEAN!!!  or 
  622.         worse,  copy  old data over new data!!   For maximum  protection, 
  623.         WRITE  PROTECT  the  disk you are  'backing  up'!   If  you  have 
  624.         specified  verification,  the DOS program DISKCOMP is run,  which 
  625.         checks that the original and the copy are identical.
  626.              If  you  specify drive C:  (the fixed disk)  as  the  source 
  627.         drive, Menu Master assumes that you wish to 'back up' one or more 
  628.         files  to diskette.   In this case,  you will not be asked for  a 
  629.         destination drive;  Menu Master assumes drive A:.
  630.              You will then next be asked:  Directory Path:
  631.         You  may  specify the directory from which files will be  'backed 
  632.         up'.  The default is the root directory.
  633.              You are next asked:  All files?
  634.         The default is 'no'.   Only files in the specified directory will 
  635.         be  copied.   An answer beginning with "y" or "Y" will cause  all 
  636.         files  in the current directory or any subdirectories  listed  in 
  637.         the current directory to be copied.
  638.              You are next asked:  Modified files only?
  639.         The  default is 'no'.   An answer beginning with 'y' or 'Y"  will 
  640.         cause only files modified since the last 'backup' to be copied.
  641.              At this point,  you are asked to Continue or Execute.   When 
  642.         the commands to back up files are executed,  you will be asked to 
  643.         insert  formatted  diskettes into drive A:  to receive the  files 
  644.         being  copied.   All previous contents of the diskettes  will  be 
  645.         lost.   NOTE:   BE  SURE TO HAVE AN ADEQUATE SUPPLY OF  FORMATTED 
  646.         DISKETTES  BEFORE PERFORMING ANY BACKUP OPERATION!!!!   ALSO,  BE 
  647.         SURE  TO  LABEL  ANY  DISKETTES  USED  FOR  BACKUP   VERY,   VERY 
  648.         CLEARLY!!!!
  649.  
  650.              If  drive  C:  is specified as the destination  drive,  Menu 
  651.         Master  assumes that you wish to restore previously  'backed  up' 
  652.         files from diskette to the hard disk.   BE SURE THAT THE CONTENTS 
  653.  
  654.  
  655.           Copyright (C) Stuart Jones 1984        Page 10
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.         OF  THE  DISKETTE FROM WHICH FILES ARE TO BE TRANSFERRED ARE  THE 
  665.         CORRECT FILES TO BE 'RESTORED'!!!!
  666.              After specifying C:  as the destination drive,  you will  be 
  667.         asked:  Directory Path:
  668.         You  must  specify  the  path to the  directory  to  receive  the 
  669.         restored files.  The default is the root directory.  
  670.              You are next asked:  Prompt if file modified?
  671.         The default is 'yes'.  If a file being restored already exists on 
  672.         the  hard  disk,  and  has  been modified since  the  version  on 
  673.         diskette was backed up,  you will be asked if you want to restore 
  674.         the version on diskette to the hard disk.   BE CAREFUL!   A WRONG 
  675.         ANSWER  TO THIS PROMPT MAY WIPE OUT ANY REVISIONS MADE SINCE  THE 
  676.         FILE WAS LAST BACKED UP!  If you reply 'no' to this question, you 
  677.         will not be asked.   It is strongly recommended that you use  the 
  678.         default answer to this question, except in unusual circumstances.
  679.              When  it  is  time to restore files,  you will be  asked  to 
  680.         insert  the  backup diskettes in the source drive.   Be  sure  to 
  681.         insert them in order (i.e.  diskette #1 first,  then diskette #2, 
  682.         etc.)  if  more than one diskette was used for  the  backup.   Of 
  683.         course, this assumes that you labelled them properly!
  684.  
  685.  
  686.         6 - Run a DOS Program or Batch File
  687.  
  688.              You are asked:  Source Disk Drive (A, B, C...):
  689.         Once  again,  the default is the drive you are  currently  using.       
  690.              You are next asked:  Directory Path:
  691.         The default is the \DOS directory.   You must specify the path to 
  692.         the program or batch file being run.
  693.              You are then asked:  Program/Batch File Name (name only):
  694.         You  need  not specify a file extension to answer this  question.  
  695.         Indeed,  you need not specify a file name.   This option  inserts 
  696.         whatever  you type in reply to the second question into the batch 
  697.         file,   menu.bat   (optionally   preceded   by   a   disk   drive 
  698.         specification).   Once you are comfortable with DOS commands, you 
  699.         can use this option to build some pretty slick batch files.   You 
  700.         can  also  use  this  option  to  perform  'delete'  or  'rename' 
  701.         operations--but this is NOT RECOMMENDED.
  702.              Indeed,  you may be wondering by now why 'Delete File(s)' or 
  703.         'Rename  File(s)' are not options in the  menu.   These  commands 
  704.         were  not overlooked.   They are not included because the  author 
  705.         believes  fervently that they should NEVER be included in a batch 
  706.         file;  the potential for disaster is just too great.  Novices, in 
  707.         particular, should rename or delete files with GREAT caution, and 
  708.         preferably without using 'wild cards'.   (Just why MICROSOFT  did 
  709.         not  include  safeguards against wholesale mistaken  deletion  or 
  710.         renaming  of files is beyond me (and most other observers).)  End 
  711.         of sermon.
  712.              You  should  of course be aware of the way  DOS  works  when 
  713.         presented with a program name for execution.   DOS is told to run 
  714.         a  program  by entering the name of the program (with or  without 
  715.         extension).   If  no  extension is specified,  DOS  searches  all 
  716.         directories  specified in paths on the specified disk for a  file 
  717.         with the specified name and one of three extensions (COM, EXE and 
  718.         BAT).   DOS  first looks for a file with the COM extension,  then 
  719.  
  720.  
  721.           Copyright (C) Stuart Jones 1984        Page 11
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.         for  one with the EXE extension,  and last for one with  the  BAT 
  731.         extension.   It  is best not to have programs with the same  name 
  732.         and  different extensions,  or programs and batch files with  the 
  733.         same names.   (This is why MMENU2.EXE is named MMENU2.EXE and not 
  734.         MENU.EXE, which would work, but be confusing.)
  735.  
  736.         7 - Run a BASIC Program
  737.  
  738.              You are asked:  Source Disk Drive (A, B, C...):
  739.              You are next asked:  Directory Path:
  740.         You  must specify the directory holding the BASIC  program.   The 
  741.         default is the root directory.
  742.              Then you are asked:  BASIC Program Name (name only):
  743.         A  default  reply  will start  up  BASICA,  without  loading  and 
  744.         executing  a BASIC program.  You must,  if you specify a  program 
  745.         name, enter the name only.  The extension BAS is assumed.
  746.  
  747.         8 - Exit to BASIC
  748.  
  749.              You are asked:  Execute Prior Commands?
  750.         The  default answer is 'yes'.   If your reply begins with  letter 
  751.         'n',  all previous options you chose are discarded.   If not, all 
  752.         the  commands put in menu.bat are retained,  and will be executed 
  753.         by DOS before BASICA is executed;  after you leave BASICA (via  a 
  754.         SYSTEM command), MMENU2 will automatically be run again.
  755.              If  you  discarded  all previous  options,  when  you  leave 
  756.         BASICA,  MMENU2 will NOT automatically be run; you will, instead, 
  757.         be returned to DOS command level.  You may then run MMENU2 either 
  758.         automatically or semi-automatically, as described above.
  759.              You  will  NOT  be asked,  (C)ontinue  or  (E)xecute?  after 
  760.         selecting  this option;  execution commences forthwith after  you 
  761.         answer the  question.
  762.  
  763.         9 - Exit to DOS
  764.  
  765.              You are asked:  Execute Prior Commands?
  766.         The default is 'yes'.   If your reply begins with letter 'n', all 
  767.         prior commands selected by you will be discarded, and you will be 
  768.         left  at  DOS command level,  regardless of how you  are  running 
  769.         MMENU2.  If not, menu.bat will be executed by DOS immediately, if 
  770.         you are running MMENU2 automatically.   As for Option  8,  MMENU2 
  771.         will exit forthwith after you answer the question.
  772.              This  option  provides an 'escape hatch' if you have made  a 
  773.         mistake with a prior command; if you answer `no` to the question, 
  774.         the contents of menu.bat will be erased, and you can start over.
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.           Copyright (C) Stuart Jones 1984        Page 12
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.         10 - Run Application From Menu
  798.  
  799.              When  MMENU2 starts up,  it looks for the file  menu.app,  a 
  800.         text file which holds a subsidiary menu of DOS commands which run 
  801.         specific applications programs.   If this file is not found, this 
  802.         option cannot be used.   In this case,  if Option 10 is selected, 
  803.         MMENU2 says:
  804.  
  805.         No Applications Present
  806.  
  807.         Press any Key to Continue
  808.  
  809.         If you press any key, you will be returned to the main menu.
  810.              Menu.app is a standard text file, which can be created using 
  811.         EDLIN or any other text editor or word processor.  The first line 
  812.         of this file is an integer number between 1 and 10,  representing 
  813.         the number of applications command lines in the remainder of  the 
  814.         file.   Each  subsequent line consists of a menu item  (displayed 
  815.         for the user to select from), followed by one or more DOS command 
  816.         lines.  The menu item is separated from the command line(s) by an 
  817.         up-arrow ('^'); individual command lines are also separated by an 
  818.         up-arrow.
  819.              As an example,  suppose that file menu.app has the following 
  820.         contents:
  821.  
  822.         2
  823.         Run Visicalc^cd\vc^a:vc80^cd\
  824.         Copy DIF Files and Delete^copy c:\vc\*.dif a:^del c:\vc\*.dif
  825.  
  826.         When  Option  10  is selected,  the screen is  cleared,  and  the 
  827.         following menu is displayed
  828.  
  829.                        Applications Menu
  830.  
  831.                  1 - Run Visicalc
  832.                  2 - Copy DIF Files and Delete
  833.  
  834.                  Your Choice:
  835.  
  836.         You  then choose from this menu as from the main  menu  (i.e.  by 
  837.         entering  a number or pressing a function key).   If you enter 0, 
  838.         or default,  you will return directly to the main menu.   If  you 
  839.         were  to  enter:  1<enter> in this example,  the  command  lines: 
  840.         'cd\vc','a:vc80',  and 'cd\' would be added to menu.bat.   If you 
  841.         entered:  2<enter>,  the command lines: 'copy c:\vc\*.dif a:' and 
  842.         'del c:\vc\*.dif' would be added to menu.bat.
  843.              Notice  that it is important to change the current directory 
  844.         back  to  the  root directory (as in the example  above)  if  you 
  845.         change current directories in your commands.
  846.              More   experienced   users  can  easily  create  their   own 
  847.         applications  menus.   Novices should use the  applications  menu 
  848.         supplied by their friends or dealer.
  849.  
  850.  
  851.  
  852.  
  853.           Copyright (C) Stuart Jones 1984        Page 13
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.                                Theory of Operation
  865.  
  866.  
  867.              The  techniques used by Menu Master are quite  simple.   DOS 
  868.         batch files may chain to each other;  therefore, if a program run 
  869.         via  one  batch  file  creates or modifies the  next  batch  file 
  870.         chained  to,  the  program effectively controls the  DOS  command 
  871.         flow.
  872.              The  implications  of this observation may be  profound  for 
  873.         developers of integrated software systems.   MMENU2 represents  a 
  874.         very  simple-minded  model for interaction of a program with  its 
  875.         batch environment.   Were it possible to 'lock out' the user from 
  876.         interfering  with  batch execution (as it is  in  many  operating 
  877.         systems  for larger computers),  this technique could be used  to 
  878.         create  modules  capable  of interaction via  the  batch  process 
  879.         itself.   Perhaps,  in  future MS-DOS releases,  this will become 
  880.         possible.
  881.              At present,  the DOS command interpreter keeps track of  the 
  882.         name  of the batch file being executed,  and the line position in 
  883.         that  file of the next command.   This consideration is used  for 
  884.         altering the current contents of the batch file being run by  DOS 
  885.         at  the time MMENU2 is executed.   At entry,  MMENU2 deletes  the 
  886.         current  contents  of menu.bat,  and writes 'cmenu' as its  first 
  887.         line.   Subsequent  commands are appended to the file,  which  is 
  888.         closed  when  MMENU2  exits.   DOS then  picks  up  execution  of 
  889.         menu.bat  with  the second line,  and proceeds to the last  line, 
  890.         which is 'menu' unless 'Exit to DOS' or 'Exit to BASIC' has  been 
  891.         chosen. 
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.           Copyright (C) Stuart Jones 1984        Page 14
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.                               Advanced Applications
  931.  
  932.  
  933.              In  this  section,  more advanced DOS users may find  a  few 
  934.         'tricks' they can perform using MMENU2.
  935.  
  936.         Changing the Default Disk Drive
  937.  
  938.              Using   Option  6,   it  is  possible  to  insert  a   drive 
  939.         specification alone into menu.bat.   This effectively changes the 
  940.         'logged-in'  or default disk drive.   The author has successfully 
  941.         used  this  trick to install MMENU2 on an 'electronic  disk'  and 
  942.         resume  automatic operation.   (Creating the batch file for  THIS 
  943.         trick  is  left  as an exercise for the  reader.)   This  may  be 
  944.         necessary  when a program to be run expects to find related files 
  945.         on the same diskette.   One should remember to change the default 
  946.         drive  back  to its original value after such a program  is  run; 
  947.         otherwise,  automatic menu operation will cease when menu.bat  is 
  948.         not  found on the new drive (this may be a desirable side  effect 
  949.         in some cases, though).
  950.  
  951.         'Electronic Disk'
  952.  
  953.              If  sufficient  memory space is available,  MMENU2  and  its 
  954.         related   files   may  be  held  on  'electronic   disk'.    This 
  955.         dramatically improves performance of MMENU2 (indeed,  this  makes 
  956.         Menu  Master  a reasonable enhancement for even  fairly  advanced 
  957.         users).   If  programs to be run must reside on disks in physical 
  958.         drives,  one  can  either specify the source drive  for  programs 
  959.         manually or change default disk assignment as above.
  960.              Some  'electronic  disk' driving programs can  be  activated 
  961.         from  within a batch file,  and will create an 'electronic  disk' 
  962.         without restarting DOS.  Such programs can be particularly useful 
  963.         in managing a batch stream.
  964.  
  965.         Starting Menu Master From 'Cold Boot'
  966.  
  967.              Advanced  users  who are configuring system disks  for  less 
  968.         experienced individuals may wish to start automatic operation  of 
  969.         MMENU2  on  startup  by adding the command,  'menu' as  the  last 
  970.         command in autoexec.bat.  MMENU2 operation from 'electronic disk' 
  971.         could also be begun thus.
  972.  
  973.         PC-DOS 2.0 Commands
  974.  
  975.              The  Applications Menu can be used to operate  a  fixed-disc 
  976.         branching  directory with minimal pain to the user.   Options  in 
  977.         this  menu  can  be  set  up by the  computer  dealer  to  switch 
  978.         directories and start up an application within and using the  new 
  979.         directory   without  additional  user  intervention.    DOS  V2.0 
  980.         commands can,  of course, also be put in batch files which may be 
  981.         invoked either via the Applications Menu or using Option 6 to run 
  982.         the  batch file by name.   Note,  however,  that if you  wish  to 
  983.  
  984.  
  985.           Copyright (C) Stuart Jones 1984        Page 15
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.         return  to  the menu automatically,  the last command in  such  a 
  995.         batch  file  MUST be 'menu'.   If you wish to return to the  menu 
  996.         only  sometimes,  insert a comment instructing the user to  press 
  997.         'control-break' to exit the batch file, and then insert a 'pause' 
  998.         command.
  999.  
  1000.         Running Menu Master in Multiple Directories
  1001.  
  1002.              Although  Menu  Master  is  designed  to  run  in  the  root 
  1003.         directory,  it  is possible to run Menu Master in more  than  one 
  1004.         directory.   To  do this,  you must copy MMENU2.EXE into the  new 
  1005.         directory, and run this program manually once to create the files 
  1006.         'menu.bat'  and 'menu.dat'.   You may then type 'menu<enter>'  to 
  1007.         start up Menu Master in the new directory.   Note,  however, that 
  1008.         all  specified  paths  will  then  be with  respect  to  the  new 
  1009.         directory.   You  can shift between directories  containing  Menu 
  1010.         Master  by  using  a  'cd' command (for option  6  or  using  the 
  1011.         applications  menu).   When  the current batch file  is  finished 
  1012.         executing, DOS will look for 'menu.bat' in the current directory, 
  1013.         whichever it may be.
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.           Copyright (C) Stuart Jones 1984        Page 16
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.